Autogenerated HTML docs for v2.1.0-243-g30d45
diff --git a/git-svn.html b/git-svn.html index cbe29f0..86e260d 100644 --- a/git-svn.html +++ b/git-svn.html
@@ -3,7 +3,7 @@ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" /> -<meta name="generator" content="AsciiDoc 8.6.6" /> +<meta name="generator" content="AsciiDoc 8.6.9" /> <title>git-svn(1)</title> <style type="text/css"> /* Shared CSS for AsciiDoc xhtml11 and html5 backends */ @@ -87,10 +87,16 @@ ul > li { color: #aaa; } ul > li > * { color: black; } -pre { +.monospaced, code, pre { + font-family: "Courier New", Courier, monospace; + font-size: inherit; + color: navy; padding: 0; margin: 0; } +pre { + white-space: pre-wrap; +} #author { color: #527bbd; @@ -219,7 +225,7 @@ } div.imageblock div.content { padding-left: 0; } -span.image img { border-style: none; } +span.image img { border-style: none; vertical-align: text-bottom; } a.image:visited { color: white; } dl { @@ -349,7 +355,7 @@ margin-bottom: 0.1em; } -div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { +div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 { margin-top: 0; margin-bottom: 0; } @@ -407,18 +413,14 @@ span.overline { text-decoration: overline; } span.line-through { text-decoration: line-through; } +div.unbreakable { page-break-inside: avoid; } + /* * xhtml11 specific * * */ -tt { - font-family: monospace; - font-size: inherit; - color: navy; -} - div.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -452,12 +454,6 @@ * * */ -.monospaced { - font-family: monospace; - font-size: inherit; - color: navy; -} - table.tableblock { margin-top: 1.0em; margin-bottom: 1.5em; @@ -537,6 +533,8 @@ @media print { body.manpage div#toc { display: none; } } + + </style> <script type="text/javascript"> /*<+'])'); + var re = new RegExp('[hH]([1-'+(toclevels+1)+'])'); // Function that scans the DOM tree for header elements (the DOM2 // nodeIterator API would be a better technique but not supported by all // browsers). @@ -610,7 +608,7 @@ var i; for (i = 0; i < toc.childNodes.length; i++) { var entry = toc.childNodes[i]; - if (entry.nodeName == 'div' + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") && entry.getAttribute("class").match(/^toclevel/)) tocEntriesToRemove.push(entry); @@ -656,7 +654,7 @@ var entriesToRemove = []; for (i = 0; i < noteholder.childNodes.length; i++) { var entry = noteholder.childNodes[i]; - if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote") + if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote") entriesToRemove.push(entry); } for (i = 0; i < entriesToRemove.length; i++) { @@ -908,7 +906,7 @@ meant that SVN-tracking refs were put at "refs/remotes/*", which is incompatible with how Git’s own remote-tracking refs are organized. If you still want the old default, you can get it by passing -<tt>--prefix ""</tt> on the command line (<tt>--prefix=""</tt> may not work if +<code>--prefix ""</code> on the command line (<code>--prefix=""</code> may not work if your Perl’s Getopt::Long is < v2.37).</td> </tr></table> </div> @@ -972,7 +970,7 @@ <p> Store Git commit times in the local time zone instead of UTC. This makes <em>git log</em> (even without --date=local) show the same times - that <tt>svn log</tt> would in the local time zone. + that <code>svn log</code> would in the local time zone. </p> <div class="paragraph"><p>This doesn’t interfere with interoperating with the Subversion repository you cloned from, but if you wish for your local Git @@ -1015,7 +1013,7 @@ <dd> <div class="listingblock"> <div class="content"> -<pre><tt>--ignore-paths="^doc"</tt></pre> +<pre><code>--ignore-paths="^doc"</code></pre> </div></div> </dd> <dt class="hdlist1"> @@ -1024,7 +1022,7 @@ <dd> <div class="listingblock"> <div class="content"> -<pre><tt>--ignore-paths="^[^/]+/(?:branches|tags)"</tt></pre> +<pre><code>--ignore-paths="^[^/]+/(?:branches|tags)"</code></pre> </div></div> </dd> </dl></div> @@ -1104,7 +1102,7 @@ This fetches revisions from the SVN parent of the current HEAD and rebases the current (uncommitted to SVN) work against it. </p> -<div class="paragraph"><p>This works similarly to <tt>svn update</tt> or <em>git pull</em> except that +<div class="paragraph"><p>This works similarly to <code>svn update</code> or <em>git pull</em> except that it preserves linear history with <em>git rebase</em> instead of <em>git merge</em> for ease of dcommitting with <em>git svn</em>.</p></div> <div class="paragraph"><p>This accepts all options that <em>git svn fetch</em> and <em>git rebase</em> @@ -1159,9 +1157,9 @@ <p> Commit to this SVN URL (the full path). This is intended to allow existing <em>git svn</em> repositories created with one transport - method (e.g. <tt>svn://</tt> or <tt>http://</tt> for anonymous read) to be + method (e.g. <code>svn://</code> or <code>http://</code> for anonymous read) to be reused if a user is later given access to an alternate transport - method (e.g. <tt>svn+ssh://</tt> or <tt>https://</tt>) for commit. + method (e.g. <code>svn+ssh://</code> or <code>https://</code>) for commit. </p> <div class="verseblock"> <pre class="content">config key: svn-remote.<name>.commiturl @@ -1177,11 +1175,11 @@ <dd> <p> Add the given merge information during the dcommit - (e.g. <tt>--mergeinfo="/branches/foo:1-10"</tt>). All svn server versions can + (e.g. <code>--mergeinfo="/branches/foo:1-10"</code>). All svn server versions can store this information (as a property), and svn clients starting from version 1.5 can make use of it. To specify merge information from multiple branches, use a single space character between the branches - (<tt>--mergeinfo="/branches/foo:1-10 /branches/bar:3,5-6,8"</tt>) + (<code>--mergeinfo="/branches/foo:1-10 /branches/bar:3,5-6,8"</code>) </p> <div class="verseblock"> <pre class="content">config key: svn.pushmergeinfo</pre> @@ -1255,8 +1253,8 @@ </p> <div class="literalblock"> <div class="content"> -<pre><tt>git config --get-all svn-remote.<name>.branches -git config --get-all svn-remote.<name>.tags</tt></pre> +<pre><code>git config --get-all svn-remote.<name>.branches +git config --get-all svn-remote.<name>.tags</code></pre> </div></div> <div class="paragraph"><p>where <name> is the name of the SVN repository as specified by the -R option to <em>init</em> (or "svn" by default).</p></div> @@ -1282,7 +1280,7 @@ </p> <div class="literalblock"> <div class="content"> -<pre><tt>git config --get-all svn-remote.<name>.commiturl</tt></pre> +<pre><code>git config --get-all svn-remote.<name>.commiturl</code></pre> </div></div> </dd> <dt class="hdlist1"> @@ -1433,6 +1431,9 @@ </p> <div class="dlist"><dl> <dt class="hdlist1"> +-B +</dt> +<dt class="hdlist1"> --before </dt> <dd> @@ -1443,6 +1444,9 @@ </p> </dd> <dt class="hdlist1"> +-A +</dt> +<dt class="hdlist1"> --after </dt> <dd> @@ -1509,12 +1513,12 @@ <dd> <p> Commits the diff of two tree-ish arguments from the - command-line. This command does not rely on being inside an <tt>git svn - init</tt>-ed repository. This command takes three arguments, (a) the + command-line. This command does not rely on being inside an <code>git svn + init</code>-ed repository. This command takes three arguments, (a) the original tree to diff against, (b) the new tree result, (c) the URL of the target Subversion repository. The final argument (URL) may be omitted if you are working from a <em>git svn</em>-aware - repository (that has been <tt>init</tt>-ed with <em>git svn</em>). + repository (that has been <code>init</code>-ed with <em>git svn</em>). The -r<revision> option is required for this. </p> </dd> @@ -1619,9 +1623,9 @@ </p> <div class="listingblock"> <div class="content"> -<pre><tt> r1---r2---r3 remotes/git-svn +<pre><code> r1---r2---r3 remotes/git-svn \ - A---B master</tt></pre> + A---B master</code></pre> </div></div> <div class="paragraph"><p>Fix the ignore-paths or SVN permissions problem that caused "r2" to be incomplete in the first place. Then:</p></div> @@ -1632,9 +1636,9 @@ </div></div> <div class="listingblock"> <div class="content"> -<pre><tt> r1---r2'--r3' remotes/git-svn +<pre><code> r1---r2'--r3' remotes/git-svn \ - r2---r3---A---B master</tt></pre> + r2---r3---A---B master</code></pre> </div></div> <div class="paragraph"><p>Then fixup "master" with <em>git rebase</em>. Do NOT use <em>git merge</em> or your history will not be compatible with a @@ -1645,9 +1649,9 @@ </div></div> <div class="listingblock"> <div class="content"> -<pre><tt> r1---r2'--r3' remotes/git-svn +<pre><code> r1---r2'--r3' remotes/git-svn \ - A'--B' master</tt></pre> + A'--B' master</code></pre> </div></div> </dd> </dl></div> @@ -1767,7 +1771,7 @@ </p> <div class="listingblock"> <div class="content"> -<pre><tt> loginname = Joe User <user@example.com></tt></pre> +<pre><code> loginname = Joe User <user@example.com></code></pre> </div></div> <div class="paragraph"><p>If this option is specified and <em>git svn</em> encounters an SVN committer name that does not exist in the authors-file, <em>git svn</em> @@ -1804,27 +1808,6 @@ </p> </dd> <dt class="hdlist1"> ---repack[=<n>] -</dt> -<dt class="hdlist1"> ---repack-flags=<flags> -</dt> -<dd> -<p> - These should help keep disk usage sane for large fetches with - many revisions. -</p> -<div class="paragraph"><p>--repack takes an optional argument for the number of revisions -to fetch before repacking. This defaults to repacking every -1000 commits fetched if no argument is specified.</p></div> -<div class="paragraph"><p>--repack-flags are passed directly to <em>git repack</em>.</p></div> -<div class="verseblock"> -<pre class="content">config key: svn.repack -config key: svn.repackflags</pre> -<div class="attribution"> -</div></div> -</dd> -<dt class="hdlist1"> -m </dt> <dt class="hdlist1"> @@ -1874,7 +1857,7 @@ <dd> <p> When retrieving svn commits into Git (as part of <em>fetch</em>, <em>rebase</em>, or - <em>dcommit</em> operations), look for the first <tt>From:</tt> or <tt>Signed-off-by:</tt> line + <em>dcommit</em> operations), look for the first <code>From:</code> or <code>Signed-off-by:</code> line in the log message and use that as the author string. </p> </dd> @@ -1885,8 +1868,8 @@ <p> When committing to svn from Git (as part of <em>commit-diff</em>, <em>set-tree</em> or <em>dcommit</em> operations), if the existing log message doesn’t already have a - <tt>From:</tt> or <tt>Signed-off-by:</tt> line, append a <tt>From:</tt> line based on the - Git commit’s author string. If you use this, then <tt>--use-log-author</tt> + <code>From:</code> or <code>Signed-off-by:</code> line, append a <code>From:</code> line based on the + Git commit’s author string. If you use this, then <code>--use-log-author</code> will retrieve a valid author string for all commits. </p> </dd> @@ -2105,7 +2088,7 @@ (ignoring tags and branches):</p></div> <div class="listingblock"> <div class="content"> -<pre><tt># Clone a repo (like git clone): +<pre><code># Clone a repo (like git clone): git svn clone http://svn.example.com/project/trunk # Enter the newly cloned directory: cd trunk @@ -2120,13 +2103,13 @@ # as well as automatically updating your working HEAD: git svn dcommit # Append svn:ignore settings to the default Git exclude file: - git svn show-ignore >> .git/info/exclude</tt></pre> + git svn show-ignore >> .git/info/exclude</code></pre> </div></div> <div class="paragraph"><p>Tracking and contributing to an entire Subversion-managed project (complete with a trunk, tags and branches):</p></div> <div class="listingblock"> <div class="content"> -<pre><tt># Clone a repo with standard SVN directory layout (like git clone): +<pre><code># Clone a repo with standard SVN directory layout (like git clone): git svn clone http://svn.example.com/project --stdlayout --prefix svn/ # Or, if the repo uses a non-standard directory layout: git svn clone http://svn.example.com/project -T tr -b branch -t tag --prefix svn/ @@ -2138,7 +2121,7 @@ # with the appropriate name): git reset --hard svn/trunk # You may only dcommit to one branch/tag/trunk at a time. The usage -# of dcommit/rebase/show-ignore should be the same as above.</tt></pre> +# of dcommit/rebase/show-ignore should be the same as above.</code></pre> </div></div> <div class="paragraph"><p>The initial <em>git svn clone</em> can be quite time-consuming (especially for large Subversion repositories). If multiple @@ -2148,7 +2131,7 @@ have each person clone that repository with <em>git clone</em>:</p></div> <div class="listingblock"> <div class="content"> -<pre><tt># Do the initial import on a server +<pre><code># Do the initial import on a server ssh server "cd /pub && git svn clone http://svn.example.com/project [options...]" # Clone locally - make sure the refs/remotes/ space matches the server mkdir project @@ -2166,7 +2149,7 @@ # --stdlayout/-T/-b/-t/--prefix options as were used on server) git svn init http://svn.example.com/project [options...] # Pull the latest changes from Subversion - git svn rebase</tt></pre> + git svn rebase</code></pre> </div></div> </div> </div> @@ -2180,9 +2163,9 @@ <em>git svn dcommit</em> subcommand to push unintegrated commits back into SVN.</p></div> <div class="paragraph"><p>Originally, <em>git svn</em> recommended that developers pulled or merged from the <em>git svn</em> branch. This was because the author favored -<tt>git svn set-tree B</tt> to commit a single head rather than the -<tt>git svn set-tree A..B</tt> notation to commit multiple commits. Use of -<em>git pull</em> or <em>git merge</em> with <tt>git svn set-tree A..B</tt> will cause non-linear +<code>git svn set-tree B</code> to commit a single head rather than the +<code>git svn set-tree A..B</code> notation to commit multiple commits. Use of +<em>git pull</em> or <em>git merge</em> with <code>git svn set-tree A..B</code> will cause non-linear history to be flattened when committing into SVN and this can lead to merge commits unexpectedly reversing previous commits in SVN.</p></div> </div> @@ -2260,7 +2243,7 @@ attempt to commit on top of the SVN commit named in</p></div> <div class="listingblock"> <div class="content"> -<pre><tt>git log --grep=^git-svn-id: --first-parent -1</tt></pre> +<pre><code>git log --grep=^git-svn-id: --first-parent -1</code></pre> </div></div> <div class="paragraph"><p>You <em>must</em> therefore ensure that the most recent commit of the branch you want to dcommit to is the <em>first</em> parent of the merge. Chaos will @@ -2300,8 +2283,8 @@ with different name spaces. For example:</p></div> <div class="literalblock"> <div class="content"> -<pre><tt>branches = stable/*:refs/remotes/svn/stable/* -branches = debug/*:refs/remotes/svn/debug/*</tt></pre> +<pre><code>branches = stable/*:refs/remotes/svn/stable/* +branches = debug/*:refs/remotes/svn/debug/*</code></pre> </div></div> </div> </div> @@ -2335,11 +2318,11 @@ listed below are allowed:</p></div> <div class="listingblock"> <div class="content"> -<pre><tt>[svn-remote "project-a"] +<pre><code>[svn-remote "project-a"] url = http://server.org/svn fetch = trunk/project-a:refs/remotes/project-a/trunk branches = branches/*/project-a:refs/remotes/project-a/branches/* - tags = tags/*/project-a:refs/remotes/project-a/tags/*</tt></pre> + tags = tags/*/project-a:refs/remotes/project-a/tags/*</code></pre> </div></div> <div class="paragraph"><p>Keep in mind that the <em>*</em> (asterisk) wildcard of the local ref (right of the <em>:</em>) <strong>must</strong> be the farthest right path component; @@ -2351,28 +2334,28 @@ comma-separated list of names within braces. For example:</p></div> <div class="listingblock"> <div class="content"> -<pre><tt>[svn-remote "huge-project"] +<pre><code>[svn-remote "huge-project"] url = http://server.org/svn fetch = trunk/src:refs/remotes/trunk branches = branches/{red,green}/src:refs/remotes/project-a/branches/* - tags = tags/{1.0,2.0}/src:refs/remotes/project-a/tags/*</tt></pre> + tags = tags/{1.0,2.0}/src:refs/remotes/project-a/tags/*</code></pre> </div></div> <div class="paragraph"><p>Multiple fetch, branches, and tags keys are supported:</p></div> <div class="listingblock"> <div class="content"> -<pre><tt>[svn-remote "messy-repo"] +<pre><code>[svn-remote "messy-repo"] url = http://server.org/svn fetch = trunk/project-a:refs/remotes/project-a/trunk fetch = branches/demos/june-project-a-demo:refs/remotes/project-a/demos/june-demo branches = branches/server/*:refs/remotes/project-a/branches/* branches = branches/demos/2011/*:refs/remotes/project-a/2011-demos/* - tags = tags/server/*:refs/remotes/project-a/tags/*</tt></pre> + tags = tags/server/*:refs/remotes/project-a/tags/*</code></pre> </div></div> <div class="paragraph"><p>Creating a branch in such a configuration requires disambiguating which location to use using the -d or --destination flag:</p></div> <div class="listingblock"> <div class="content"> -<pre><tt>$ git svn branch -d branches/server release-2-3-0</tt></pre> +<pre><code>$ git svn branch -d branches/server release-2-3-0</code></pre> </div></div> <div class="paragraph"><p>Note that git-svn keeps track of the highest revision in which a branch or tag has appeared. If the subset of branches or tags is changed after @@ -2418,7 +2401,7 @@ <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -Last updated 2014-06-06 12:15:38 PDT +Last updated 2014-09-18 12:05:28 PDT </div> </div> </body> 